Skip to content

Conversation

@foxg1ove1
Copy link

… example crates; update .gitignore to ignore Cargo.lock and target; include rtthread.h updates

拉取/合并请求描述:(PR description)

[

为什么提交这份PR (why to submit this PR)

  • 随着 Rust 在系统级开发中的广泛应用,为 RT-Thread 引入一等支持有助于提升安全性、可维护性与开发效率。
  • 通过标准化构建与配置流程,让 Rust 组件在多 BSP 上实现稳定构建与链接。

你的解决方案是什么 (what is your solution)

在 rt-thread/components/rust 引入 Rust 核心组件、宏库与示例,并与 Kconfig、Cargo、SCons 深度集成。

请提供验证的bsp和config (provide the config and bsp)

  • BSP:
  • .config:
  • action:

]

当前拉取/合并请求的状态 Intent for your PR

必须选择一项 Choose one (Mandatory):

  • 本拉取/合并请求是一个草稿版本 This PR is for a code-review and is intended to get feedback
  • 本拉取/合并请求是一个成熟版本 This PR is mature, and ready to be integrated into the repo

代码质量 Code Quality:

我在这个拉取/合并请求中已经考虑了 As part of this pull request, I've considered the following:

  • 已经仔细查看过代码改动的对比 Already check the difference between PR and old code
  • 代码风格正确,包括缩进空格,命名及其他风格 Style guide is adhered to, including spacing, naming and other styles
  • 没有垃圾代码,代码尽量精简,不包含#if 0代码,不包含已经被注释了的代码 All redundant code is removed and cleaned up
  • 所有变更均有原因及合理的,并且不会影响到其他软件组件代码或BSP All modifications are justified and not affect other components or BSP
  • 对难懂代码均提供对应的注释 I've commented appropriately where code is tricky
  • 代码是高质量的 Code in this PR is of high quality
  • 已经使用formatting 等源码格式化工具确保格式符合RT-Thread代码规范 This PR complies with RT-Thread code specification
  • 如果是新增bsp, 已经添加ci检查到.github/ALL_BSP_COMPILE.json 详细请参考链接BSP自查

… example crates; update .gitignore to ignore Cargo.lock and target; include rtthread.h updates
@CLAassistant
Copy link

CLAassistant commented Nov 8, 2025

CLA assistant check
All committers have signed the CLA.

@github-actions
Copy link

github-actions bot commented Nov 8, 2025

👋 感谢您对 RT-Thread 的贡献!Thank you for your contribution to RT-Thread!

为确保代码符合 RT-Thread 的编码规范,请在你的仓库中执行以下步骤运行代码格式化工作流(如果格式化CI运行失败)。
To ensure your code complies with RT-Thread's coding style, please run the code formatting workflow by following the steps below (If the formatting of CI fails to run).


🛠 操作步骤 | Steps

  1. 前往 Actions 页面 | Go to the Actions page
    点击进入工作流 → | Click to open workflow →

  2. 点击 Run workflow | Click Run workflow

  • 设置需排除的文件/目录(目录请以"/"结尾)
    Set files/directories to exclude (directories should end with "/")
  • 将目标分支设置为 \ Set the target branch to:rust
  • 设置PR number为 \ Set the PR number to:10910
  1. 等待工作流完成 | Wait for the workflow to complete
    格式化后的代码将自动推送至你的分支。
    The formatted code will be automatically pushed to your branch.

完成后,提交将自动更新至 rust 分支,关联的 Pull Request 也会同步更新。
Once completed, commits will be pushed to the rust branch automatically, and the related Pull Request will be updated.

如有问题欢迎联系我们,再次感谢您的贡献!💐
If you have any questions, feel free to reach out. Thanks again for your contribution!

@github-actions
Copy link

github-actions bot commented Nov 8, 2025

📌 Code Review Assignment

🏷️ Tag: components

Reviewers: Maihuanyi

Changed Files (Click to expand)
  • components/Kconfig
  • components/SConscript
  • components/rust/Kconfig
  • components/rust/README.md
  • components/rust/README_cn.md
  • components/rust/SConscript
  • components/rust/core/.gitignore
  • components/rust/core/Cargo.toml
  • components/rust/core/SConscript
  • components/rust/core/rust_cmd.c
  • components/rust/core/src/allocator.rs
  • components/rust/core/src/api/base.rs
  • components/rust/core/src/api/interrupt.rs
  • components/rust/core/src/api/libloading.rs
  • components/rust/core/src/api/mem.rs
  • components/rust/core/src/api/mod.rs
  • components/rust/core/src/api/mutex.rs
  • components/rust/core/src/api/queue.rs
  • components/rust/core/src/api/sem.rs
  • components/rust/core/src/api/thread.rs
  • components/rust/core/src/bindings/libc.rs
  • components/rust/core/src/bindings/librt.rs
  • components/rust/core/src/bindings/mod.rs
  • components/rust/core/src/fs.rs
  • components/rust/core/src/init.rs
  • components/rust/core/src/lib.rs
  • components/rust/core/src/libloader.rs
  • components/rust/core/src/mutex.rs
  • components/rust/core/src/out.rs

📊 Current Review Status (Last Updated: 2025-11-11 19:28 CST)

  • Maihuanyi Pending Review

📝 Review Instructions

  1. 维护者可以通过单击此处来刷新审查状态: 🔄 刷新状态
    Maintainers can refresh the review status by clicking here: 🔄 Refresh Status

  2. 确认审核通过后评论 LGTM/lgtm
    Comment LGTM/lgtm after confirming approval

  3. PR合并前需至少一位维护者确认
    PR must be confirmed by at least one maintainer before merging

ℹ️ 刷新CI状态操作需要具备仓库写入权限。
ℹ️ Refresh CI status operation requires repository Write permission.

@Maihuanyi
Copy link
Contributor

CLA assistant check Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.You have signed the CLA already but the status is still pending? Let us recheck it.

感谢你为rtthread的贡献,请签这个贡献者许可协议;

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This pull request adds comprehensive Rust programming language support to the RT-Thread RTOS, enabling developers to write RT-Thread components and applications in Rust. The implementation includes core FFI bindings, procedural macros, build system integration, examples, and bilingual documentation.

Key changes:

  • Complete Rust core library with RT-Thread API bindings and safe wrappers
  • Procedural macros for component/application/command exports
  • Automated multi-architecture target detection (ARM, AArch64, RISC-V)
  • Build system integration with SCons and Cargo
  • Comprehensive examples demonstrating threads, mutexes, queues, file I/O, and dynamic loading
  • Bilingual documentation (English/Chinese) following RT-Thread guidelines

Reviewed Changes

Copilot reviewed 88 out of 89 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
components/rust/core/src/bindings/libc.rs FFI bindings for C standard library functions with minor spelling issue
components/rust/examples/modules/example_lib/Cargo.toml Example library configuration with incorrect Rust edition "2024"
components/rust/examples/application/fs/src/lib.rs File system example with spelling error in comment
components/rust/core/* Core Rust library implementing RT-Thread API wrappers
components/rust/rt_macros/* Procedural macros for RT-Thread integration
components/rust/tools/* Build support scripts for target detection and compilation
components/rust/examples/* Comprehensive examples for applications, components, and modules
components/rust/docs/* Bilingual documentation for tools, applications, components, and modules

pub const RTLD_NOW: c_int = 0x00001; // Immediate function call binding
pub const RTLD_GLOBAL: c_int = 0x10000; // Make symbols globally available
pub const RTLD_LOCAL: c_int = 0x00000; // Default local
// fcntl.h interent constants
Copy link

Copilot AI Nov 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling Error / 拼写错误

English: The word "interent" should be "internet" or possibly "inherit".
中文:单词"interent"应该是"internet"或者"inherit"。

Suggested correction: Change fcntl.h interent constants to fcntl.h inherit constants or fcntl.h integer constants depending on the intended meaning.

Suggested change
// fcntl.h interent constants
// fcntl.h integer constants

Copilot uses AI. Check for mistakes.
*
* Change Logs:
* Date Author notes
* 2025-10-20 foxglove Rust file opration test.
Copy link

Copilot AI Nov 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling Error / 拼写错误

English: The word "opration" should be "operation".
中文:单词"opration"应该是"operation"。

Suggested correction: Change Rust file opration test to Rust file operation test.

Copilot uses AI. Check for mistakes.
@@ -0,0 +1,30 @@
import sys
import os
from building import *
Copy link

Copilot AI Nov 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Import pollutes the enclosing namespace, as the imported module building does not define 'all'.

Copilot uses AI. Check for mistakes.
@@ -0,0 +1,26 @@
import sys
import os
from building import *
Copy link

Copilot AI Nov 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Import pollutes the enclosing namespace, as the imported module building does not define 'all'.

Copilot uses AI. Check for mistakes.
#ifdef RT_USING_FINSH
#include <finsh.h>
#endif /* RT_USING_FINSH */
#ifdef RT_USING_MODULE
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里不应该修改的,而是在使用的文件中来包含这个头文件。

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

在根据RT-Thread社区开启动态模块加载的指南 [动态模块](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/libc/posix/dlmodule) 配置好项目后,编译项目时会遇到这样的问题:

.../rt-thread/src/defunct.c: In function 'rt_defunct_execute':
.../rt-thread/src/defunct.c:91:13: error: implicit declaration of function 'dlmodule_destroy' [-Wimplicit-function-declaration]
   91 |             dlmodule_destroy(module);
      |             ^~~~~~~~~~~~~~~~

所以更改为:在 defunct.c 文件导入 dlmodule.h

import os
from building import *

cwd = GetCurrentDir()
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

建议在顶层中加入对 RT_USING_RUST 的依赖判断,当不启用时就不向下扩展了。而打开 RT_USING_RUST 时才需要在Python层面import toml包。

@github-actions github-actions bot added the Kernel PR has src relate code label Nov 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Component Kernel PR has src relate code ®️ust

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants